Carbon


SPBGetDeviceInfo

Header: Sound.h Carbon status: Supported

Obtains information about the settings of a sound input device.

OSErr SPBGetDeviceInfo (
    SInt32 inRefNum, 
    OSType infoType, 
    void *infoData
);
Parameter descriptions
inRefNum

The device reference number of the sound input device, as obtained from the SPBOpenDevice function.

infoType

A sound input device information selector that specifies the type of information you need. The available sound input device information selectors are listed in “Sound Input Device and Sound Component Information Selectors”.

infoData

A pointer to a buffer in which information should be returned. This buffer must be large enough for the type of information specified in the infoType parameter.

function result

A result code.

SPECIAL CONSIDERATIONS

Because the SPBGetDeviceInfo function might move memory, you should not call it at interrupt time. Check the selector description of the selector you want to use to see if it moves memory before calling the SPBGetDeviceInfo function. Most of the selectors do not move memory and are therefore safe to use at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)